de.ueberdosis.mp3info.id3v2
Class FrameOWNE

java.lang.Object
  |
  +--de.ueberdosis.mp3info.id3v2.ID3V2Frame
        |
        +--de.ueberdosis.mp3info.id3v2.FrameOWNE
All Implemented Interfaces:
Defines

public class FrameOWNE
extends ID3V2Frame

Ownership frame The ownership frame might be used as a reminder of a made transaction or, if signed, as proof. Note that the "USER" and "TOWN" frames are good to use in conjunction with this one. The frame begins, after the frame ID, size and encoding fields, with a 'price payed' field. The first three characters of this field contains the currency used for the transaction, encoded according to ISO-4217 alphabetic currency code. Concatenated to this is the actual price payed, as a numerical string using "." as the decimal separator. Next is an 8 character date string (YYYYMMDD) followed by a string with the name of the seller as the last field in the frame. There may only be one "OWNE" frame in a tag.

Text encoding $xx Price payed $00 Date of purch. Seller


Field Summary
 
Fields inherited from class de.ueberdosis.mp3info.id3v2.ID3V2Frame
dataChanged, deprecatedSince, legalSince
 
Fields inherited from interface de.ueberdosis.mp3info.Defines
DEFAULT_ENCODING, ID3V2_FOOTER_SIZE, ID3V2_FRAME_HEADER_SIZE, ID3V2_HEADER_SIZE, ID3V2_X_HEADER_SIZE, MP3_FRAME_HEADER_SIZE, SUPPORTED_NUMBER_OF_EXTENDED_FLAG_BYTES, testPositions, VERSION
 
Constructor Summary
FrameOWNE(de.ueberdosis.mp3info.id3v2.ID3V2Frame frm, de.ueberdosis.mp3info.id3v2.DataSource ds)
           
 
Method Summary
 boolean canDisplay()
          Can be displayed
 boolean canEdit()
          Can be edited
 boolean containsData()
          Denotes if actual data are in this frame.
 de.ueberdosis.mp3info.gui.Id3JPanel createJPanel(boolean edit, boolean selfupdate)
          Creates a JPanel to display or edit the contents of the frame.
 int deprecatedSince()
          Informs since which version of ID3V2 this Frame has become illegal Only major versions are supported.
 byte[] getData()
          creates an byte array containing the data in the Frame.
 java.lang.String getLongName()
           
 java.lang.String getPricePayed()
           
 java.lang.String getPurchaseDate()
           
 java.lang.String getSeller()
           
 int legalSince()
          Informs since which version of ID3V2 this Frame is legal Only major versions are supported (eg.
 void setPricePayed(java.lang.String p)
           
 void setPurchaseDate(java.lang.String p)
           
 void setSeller(java.lang.String s)
           
 java.lang.String toString()
           
 
Methods inherited from class de.ueberdosis.mp3info.id3v2.ID3V2Frame
createPanel, equals, getDataLengthIndicator, getFileAlterPreservation, getFrameID, getSize, getTagAlterPreservation, getUnsynchronisation, hasGroupingIdentity, isAltered, isCompressed, isEncrypted, isReadOnly, isValid, toByteArray
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

FrameOWNE

public FrameOWNE(de.ueberdosis.mp3info.id3v2.ID3V2Frame frm,
                 de.ueberdosis.mp3info.id3v2.DataSource ds)
          throws SeekPastEndException
Method Detail

legalSince

public int legalSince()
Description copied from class: ID3V2Frame
Informs since which version of ID3V2 this Frame is legal Only major versions are supported (eg. 4 stands for ID3 v 2.4.0)

Overrides:
legalSince in class ID3V2Frame
Returns:
a number between 0 and (currently) 4. -1 means the actual frame didn't overwrite the method.

deprecatedSince

public int deprecatedSince()
Description copied from class: ID3V2Frame
Informs since which version of ID3V2 this Frame has become illegal Only major versions are supported.

Overrides:
deprecatedSince in class ID3V2Frame
Returns:
a number between -1 and (currently) 4 denoting the first version that does NOT support this frame anymore. -1 (in combination with a sane return of legalSince ()) means this frame is not deprecated.

getLongName

public java.lang.String getLongName()

toString

public java.lang.String toString()
Overrides:
toString in class ID3V2Frame

getData

public byte[] getData()
Description copied from class: ID3V2Frame
creates an byte array containing the data in the Frame. Dummy implementation, to be overwritten by the actual Frames

Overrides:
getData in class ID3V2Frame

containsData

public boolean containsData()
Description copied from class: ID3V2Frame
Denotes if actual data are in this frame. Some Frames have a minimum size that is greater than the header although they don't contain any data. So I can't generally determine if a Frame is empty just by asking for its size.
To be overwritten by subclasses.

Overrides:
containsData in class ID3V2Frame

getPricePayed

public java.lang.String getPricePayed()

setPricePayed

public void setPricePayed(java.lang.String p)

getPurchaseDate

public java.lang.String getPurchaseDate()

setPurchaseDate

public void setPurchaseDate(java.lang.String p)

getSeller

public java.lang.String getSeller()

setSeller

public void setSeller(java.lang.String s)

canEdit

public boolean canEdit()
Can be edited

Overrides:
canEdit in class ID3V2Frame

canDisplay

public boolean canDisplay()
Can be displayed

Overrides:
canDisplay in class ID3V2Frame

createJPanel

public de.ueberdosis.mp3info.gui.Id3JPanel createJPanel(boolean edit,
                                                        boolean selfupdate)
Description copied from class: ID3V2Frame
Creates a JPanel to display or edit the contents of the frame. To be overwritten by subclasses. The results of canDisplay / canEdit are only binding for this method (ie. for JPanels). AWT-Panels may or may not be implemented.

Overrides:
createJPanel in class ID3V2Frame
Parameters:
edit - switches between display- (false) and edit-mode (true)
selfupdate - switches if the created component takes care of updating its data or not. Generally this means that the component carries its own update-button.
Of course, selfupdate is useless without edit set to true.
Returns:
a JPanel that can be used to display or edit the contents